Case Sensitive

Do the attributes and values in the spec all case-sensitive in both request and response?

YES. That is correct.

Optional Fields

Regarding the optional fields on API Spec, it needs to be implemented or not?

It depends on the Distributors' business needs and actual situations. If Distributors determine that some optional fields are useless, they don't need to develop them. However, distributors ensure that their system does not occur errors or affect the business flow when interacting with the interfaces of DerbySoft.

ABT and AAT

What do ABT and AAT stand for? Which APIs use ABT and AAT?

ABT (@AmountBeforeTax) and AAT (@AmountAfterTax) are used to respond to several APIs including Reservation, Query, Multi-Property Availability Check, and Live Availability Check.

How are ABT and AAT used in In Reservation and Query API?

In Reservation and Query, ABT and AAT could be returned under <'Total’> node. RoomRates along with ABT / AAT under it are only returned when the supplier such as IHG uses ExtraPersonCharge. ABT / AAT under <'Total’> is always returned. Some suppliers such as Hyatt have free night promotion activities. For the line of the free night, both ABT and AAT are 0.

Please contact the Support Team via  go.help@derbysoft.net if you cannot handle a $0 rate. Note that ABT and AAT under <'Total’> cannot be 0.

In Multi-Property Availability Check and Live Availability Check, ABT and AAT indicate rate PER ROOM PER NIGHT. When ABT and AAT of each night during the stay are provided by the supplier, the exact rate of each night will be returned to the distributor. The lines with the same rate will be merged. The scenario below illustrates the way the rate returns in Multi-Property Availability Check and Live Availability Check.

How does Go handle the situation when only AAT or ABT is returned?

Go has to handle logic as below for ABT / AAT fully or partially returned from the suppliers:

1. In general, Go pass-through or provide ABT / AAT directly to Go Distributor directly which means it depends on what provide by the hotel supplier.    
2. If a supplier return ABT only, Go has the ability to calculate the room rate from ABT to AAT according to the tax/fee rules provided by the supplier. But there are 2 preconditions. One is tax/fee rules should be provided by the supplier since it's used by the room rate calculation logic. The other is reaching out to the Go Help Team to turn on the calculate switch.

Reservation

What is IATA? Where is IATA used in Go?

The International Air Transport Association (IATA) is the trade association for the world’s airlines, representing 83% of total air traffic. IATA supports many areas of aviation activity and helps formulate industry policy on critical aviation issues. IATA members are granted an IATA code. With time going on, the benefits IATA members can enjoy are expended from airline booking to hotel reservations. IATA code is required by some hotel suppliers depending on your agreement with the supplier. The distributor may leave this item blank if not an IATA member.

Can I reserve more than one room in one reservation request?

More than one room can be reserved in one reservation request by identifying the value of @NumberOfUnits. But these rooms need to have the same room type, rate plan, and guest count. Otherwise, more than one request is needed. For example, two requests will be needed if you need one room with a King bed and one room with 2 Doubles. Refer to the following three scenarios for more information.

Live Availability Check

In some cases, there is no availability returned from the Supplier CRS although there was availability returned earlier to a multi-property avail request. What could be the possible reason and the solution?

The possible reason can be:

Room rate/Inventory/status is out of sync between the Supplier CRS and GO. For this case, please kindly wait for the next round of ARI Sync Task to be triggered automatically. Indeed, if it's an emergency case, please don't hesitate to reach out to the Go Help Team.

Payment

What are the payment card supported by Go?

DerbySoft passes the distributor’s credit card information to suppliers for payment. SUCC (Single User Credit Card), VCC (Virtual Credit Card), or guest credit card are supported depending on the business term between you and the supplier.

What’s the refund process if I do not use a credit card for payment?

Credit card information is not required in the booking request if you don’t use a credit card for payment. In this case, you need to deal with refunds with suppliers directly.

Currency

When the Distributor’s currency is different from that of the Supplier, which currency will be used? Can Go convert the rates from Supplier’s currency to Distributor’s currency?

Go returns the rates with currencies provided by the Suppliers in Shopping APIs and Reservation APIs. In the requests and responses, it is not allowed for Go or Distributors to use Distributor’s currency when it is different from that of the Supplier. Rates with the Distributor’s currency will not be accepted by the Supplier.

Security

What is the standard Go follows to ensure a secure transaction?

Go follows PCI Security Standard in the requests of Reservation, Cancellation, and Query. On the other hand, all requests are transferred with HTTPS which is an encrypted protocol. Authentication information is included in HTTP Header, which ensures each request is secured and authorized.

Monitoring

Will there be any support provided if a critical issue with Go is encountered after work?

DerbySoft provides 24X7 service to our customers. You can always email our Support Team via resv@derbysoft.com for critical issues at any time. Moreover, real-time monitoring is still on after work. The indexes being monitored include service issue rate, service response timer, service interruption, and cache data accessible status. When the value of any index exceeds the threshold, Our Support Team will be informed for immediate processing.